home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / disk / backman019b.lha / BackMan.Doc < prev    next >
Encoding:
Text File  |  1995-02-13  |  7.4 KB  |  155 lines
  1.    NAME
  2.     BackMan -- backs up your data.
  3.  
  4.    INPUTS
  5.     DRIVE/K - drive name(s), as DF0:, PC0:, etc.
  6.         Doesn't need trailing colon, but will be truncated at the first
  7.         colon if present (i.e. you could say "DF0:foo" if you really
  8.         wanted to).
  9.  
  10.     DEVICE/K - name of trackdisk-like Exec device (say, scsi.device).
  11.         The device must support the TD_GETGEOMETRY command to work with
  12.         BackMan. Almost any trackdisk-like device will do, but if you get
  13.         unlikely disk sizes it probably lacks full support of the command
  14.         in question (for example, diskspare.device 1.6 will say it can
  15.         hold something like 512 Mb per disk).
  16.  
  17.         However, avoid naming the device itself and stick to the standard
  18.         DOS drive name if possible (DFx: for trackdisk.device, PCx: for
  19.         mfm.device, etc.), because the interface is much more reliable.
  20.  
  21.     NOCOM/S - don't backup/restore file comment.
  22.         Especially useful when restoring files to a MS-DOS® disk or
  23.         partition handled by CrossDOS® (or similar), since the MS-DOS®
  24.         file system doesn't support comments and you would get a "Can't
  25.         set comment" error for every file that has a comment. Can also
  26.         save some memory and disk space if you don't need to backup
  27.         comments and your files have them.
  28.  
  29.         NOTE: this options refers to files' comments, while the next
  30.         refers to the global backup comment. Don't confuse the two.
  31.  
  32.     COM=COMMENT/K - backup comment.
  33.         This comment will be shown every time the backup is read.
  34.  
  35.         By default, the comment will be set to the name of the drawer
  36.         being backed up.
  37.  
  38.    KEYS
  39.     You can stop (pause) and restart BackMan by pressing CTRL-E and
  40.     CTRL-F, respectively. You can abort BackMan by pressing CTRL-C.
  41.  
  42.    NOTES
  43.     The secondary file list
  44.     ~~~~~~~~~~~~~~~~~~~~~~~
  45.     On backup, BackMan will write the file list twice: once at the
  46.     beginning of the backup and once again at the end. In this way you
  47.     will have a chance of recovering your backup, should the first file
  48.     list be corrupted by chance or by mistake.
  49.  
  50.     On restore, if you insert the last disk of a backup when asked for
  51.     the first, then BackMan will ask you if you want to read the file
  52.     list from that disk: you can safely do so if you want, but you will
  53.     do one disk swap more than if you read the file list from the first
  54.     disk.
  55.  
  56.     Please note that the secondary file list could actually start on the
  57.     last but one disk: in this case BackMan will request the correct
  58.     disk. This can happen because there could be just a little bit of
  59.     space left on the last but one disk, but not enough to contain the
  60.     whole file list, so it will be split between the last two disks.
  61.  
  62.     The secondary file list could actually start on even earlier disks if
  63.     your backup contained an extremely large number of files (more than
  64.     3128 files in the worst case, usually over ten thousands). In this
  65.     case it will span more than two disks.
  66.  
  67.     Existing files
  68.     ~~~~~~~~~~~~~~
  69.     When you are asked for a new file name (if you selected to rename an
  70.     already existing file), you can select the Cancel button of the
  71.     "Enter new name" requester to skip the file in question.
  72.  
  73.     CMD_FORMAT or CMD_WRITE?
  74.     ~~~~~~~~~~~~~~~~~~~~~~~~
  75.     By default BackMan writes data to disk using TD_FORMAT for DOS
  76.     drives, while it will use CMD_WRITE for Exec devices. This behaviour
  77.     is meant to speed up floppy disk operations (TD_FORMAT is quite
  78.     faster than CMD_WRITE on floppy disks), while it is better suited for
  79.     direct writes to hard disks, removables, or non-floppy data storage
  80.     peripherals in general (SyQuest drives and tape drives, for example),
  81.     which sometimes don't like being formatted. However, this logic is
  82.     not perfect, so you can force the use CMD_WRITE by unselecting the
  83.     "Format" checkmark in the configuration window.
  84.  
  85.     BackMan has been tested with trackdisk.device, ramdrive.device,
  86.     mfm.device (as supplied with WB 3.1), diskspare.device (public
  87.     domain, formats standard DD disks to 960 or 984 kb),
  88.     ?compressdisk.device?
  89.  
  90.     NOTE FOR THE NOVICE USER: forget about all this, DON'T try to backup
  91.     your data to hard disks and DON'T use direct Exec device access
  92.     (except as instructed for tape drives) unless you are absolutely sure
  93.     of what you're doing. You could lose the data you're backing up and
  94.     much more by improper use of these options.
  95.  
  96.    WARNINGS
  97.     It is the user's responsibility to prevent any changes to the files
  98.     being backed up in the time interval from when the directory is read
  99.     to when the file is effectively backed up on disk, tape, or whatever.
  100.     Any changes would result in more or less inconsistent data being
  101.     written to the backup, particularly if the file size is changed.
  102.     BackMan will notice changes in file size and abort the backup (no
  103.     recovery would be possible, except rewriting most of the backup from
  104.     the beginning), but other, although less relevant, changes to the
  105.     file attributes will deliberately go unnoticed.
  106.  
  107.     If you are really really paranoid, I'd suggest to make a backup copy
  108.     of the first and/or last backup disks, because these two disks
  109.     contain the main and secondary file lists: in this way you will be
  110.     more protected against corruption of said lists, without whom it is
  111.     impossible to restore the backup.
  112.  
  113.     BackMan can't handle backups of more than about 2 gigabytes of data.
  114.     But then, is there anybody out there who backs up 2 Gb in a single
  115.     shot? ;) (If you're curious, it would take over 2383 DD disks...)
  116.  
  117.     diskspare.device has proven to be not very reliable when used through
  118.     the DEVICE option, so please avoid using it in this way and stick to
  119.     DRIVE after mounting the appropriate DOS driver.
  120.  
  121.    ESOTERIC SUGGESTIONS
  122.     If you want to transfer data between two nearby computers without
  123.     setting up some kind of network and you choose BackMan, you don't
  124.     need to do the whole backup: you need just one disk, though it would
  125.     be better to have a couple more so you can backup on one computer and
  126.     restore on the other at the same time. Simply start BackMan on both
  127.     computers, and move the disks from one computer to the other as soon
  128.     as they're finished. You have to set the "Ignore contents" option on
  129.     the computer that is doing the backup, otherwise it will reject the
  130.     disks because they belong to the current backup.
  131.  
  132.    NO WARRANTY
  133.     THERE IS NO WARRANTY, EITHER EXPRESSED OR IMPLIED, AS TO THE QUALITY
  134.     OR PERFORMANCE OF THIS PROGRAM. THE ENTIRE RISK FOR THE USE OF THIS
  135.     PROGRAM IS ASSUMED BY THE USER (YOU). THE AUTHORS MAY NOT BE HELD
  136.     RESPONSIBLE FOR ANY LOSS OR CORRUPTION OF DATA, EQUIPMENT OR OTHER
  137.     GOODS RESULTING BY THE USE OR POSSESSION OF THIS PROGRAM, EVEN IF IN
  138.     KNOWLEDGE THAT SUCH LOSS OR CORRUPTION MIGHT HAPPEN.
  139.  
  140.     However, the authors dedicated themselves to ensure that the program
  141.     will behave very likely as described in this manual and that it does
  142.     not contain evident flaws. It has been continuously and thoroughly
  143.     tested throughout development, and it has proven to be reliable in
  144.     everyday use. The authors are willing to maintain the program and
  145.     correct misbehaviours, though they cannot make any promises on this.
  146.  
  147.     In other words, we did our best to write a reliable backup program
  148.     and in fact we rely on it enough to use it for our very own backups,
  149.     but we wrote enough programs to know that there is always another
  150.     bug, no matter how good the programmer is. Be careful the first times
  151.     you try a program like this, which will be responsible of keeping
  152.     your data safe, and start using it for important backups only after
  153.     you've acquired a certain feeling on it.
  154.  
  155.